<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  <title>std.string</title>
  <link href="./css/style.css" rel="stylesheet" type="text/css"/>
  <!-- <link href="./img/icon.png" rel="icon" type="image/png"/> -->
  <script type="text/javascript" src="./js/jquery.js"></script>
  <script type="text/javascript" src="./js/modules.js"></script>
  <script type="text/javascript" src="./js/quicksearch.js"></script>
  <script type="text/javascript" src="./js/navigation.js"></script>
  <!--<script type="text/javascript" src="./js/jquery.treeview.js"></script>-->
  <script type="text/javascript">
    var g_moduleFQN = "std.string";
  </script>
  
</head>
<body>
<div id="content">
  <h1><a href="./htmlsrc/std.string.html" class="symbol">std.string</a></h1>
  
<div class="summary">String handling functions. Objects of types <span class="d_psymbol"><i>string</i></span>, <span class="d_psymbol"><i>
 wstring</i></span>, and <span class="d_psymbol"><i>dstring</i></span> are value types and cannot be mutated
 element-by-element. For using mutation during building strings, use
 <span class="d_psymbol"><i>char[]</i></span>, <span class="d_psymbol"><i>wchar[]</i></span>, or <span class="d_psymbol"><i>dchar[]</i></span>. The <span class="d_psymbol"><i>*string</i></span> types
 are preferable because they don't exhibit undesired aliasing, thus
 making code more robust.</div>
<p class="sec_header">Authors:</p><a href="http://digitalmars.com">Walter Bright</a>, <a href="http://erdani.org">Andrei
Alexandrescu</a>
<dl>
<dt class="decl">size_t <a class="symbol _function" name="wcslen" href="./htmlsrc/std.string.html#L54" kind="function" beg="54" end="54">wcslen</a><span class="params">(in wchar *)</span>; <span class="attrs">[<span class="linkg">extern(C)</span>]</span> <a title="Permalink to this symbol" href="#wcslen" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L54">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">int <a class="symbol _function" name="wcscmp" href="./htmlsrc/std.string.html#L55" kind="function" beg="55" end="55">wcscmp</a><span class="params">(in wchar *, in wchar *)</span>; <span class="attrs">[<span class="linkg">extern(C)</span>]</span> <a title="Permalink to this symbol" href="#wcscmp" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L55">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">typedef object.Exception <a class="symbol _typedef" name="StringException" href="./htmlsrc/std.string.html#L61" kind="typedef" beg="61" end="61">StringException</a>; <a title="Permalink to this symbol" href="#StringException" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L61">#</a></dt>
<dd class="ddef">
<div class="summary">Thrown on errors in string functions.</div></dd>
<dt class="decl">char[16] <a class="symbol _variable" name="hexdigits" href="./htmlsrc/std.string.html#L65" kind="variable" beg="65" end="65">hexdigits</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#hexdigits" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L65">#</a></dt>
<dd class="ddef">
<div class="summary">0..9A..F</div></dd>
<dt class="decl">char[10] <a class="symbol _variable" name="digits" href="./htmlsrc/std.string.html#L66" kind="variable" beg="66" end="66">digits</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#digits" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L66">#</a></dt>
<dd class="ddef">
<div class="summary">0..9</div></dd>
<dt class="decl">char[8] <a class="symbol _variable" name="octdigits" href="./htmlsrc/std.string.html#L67" kind="variable" beg="67" end="67">octdigits</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#octdigits" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L67">#</a></dt>
<dd class="ddef">
<div class="summary">0..7</div></dd>
<dt class="decl">char[26] <a class="symbol _variable" name="lowercase" href="./htmlsrc/std.string.html#L68" kind="variable" beg="68" end="68">lowercase</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#lowercase" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L68">#</a></dt>
<dd class="ddef">
<div class="summary">a..z</div></dd>
<dt class="decl">char[26] <a class="symbol _variable" name="uppercase" href="./htmlsrc/std.string.html#L69" kind="variable" beg="69" end="69">uppercase</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#uppercase" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L69">#</a></dt>
<dd class="ddef">
<div class="summary">A..Z</div></dd>
<dt class="decl">char[52] <a class="symbol _variable" name="letters" href="./htmlsrc/std.string.html#L70" kind="variable" beg="70" end="71">letters</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#letters" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L70">#</a></dt>
<dd class="ddef">
<div class="summary">A..Za..z</div></dd>
<dt class="decl">char[6] <a class="symbol _variable" name="whitespace" href="./htmlsrc/std.string.html#L72" kind="variable" beg="72" end="72">whitespace</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#whitespace" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L72">#</a></dt>
<dd class="ddef">
<div class="summary">ASCII whitespace</div></dd>
<dt class="decl">dchar <a class="symbol _variable" name="LS" href="./htmlsrc/std.string.html#L74" kind="variable" beg="74" end="74">LS</a>; <span class="attrs">[<span class="stc">manifest</span>]</span> <a title="Permalink to this symbol" href="#LS" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L74">#</a></dt>
<dd class="ddef">
<div class="summary">UTF line separator</div></dd>
<dt class="decl">dchar <a class="symbol _variable" name="PS" href="./htmlsrc/std.string.html#L75" kind="variable" beg="75" end="75">PS</a>; <span class="attrs">[<span class="stc">manifest</span>]</span> <a title="Permalink to this symbol" href="#PS" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L75">#</a></dt>
<dd class="ddef">
<div class="summary">UTF paragraph separator</div></dd>
<dt class="decl">char[1] <a class="symbol _variable" name="newline" href="./htmlsrc/std.string.html#L81" kind="variable" beg="81" end="81">newline</a>; <span class="attrs">[<span class="stc">invariant</span>]</span> <a title="Permalink to this symbol" href="#newline" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L81">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">bool <a class="symbol _function" name="iswhite" href="./htmlsrc/std.string.html#L87" kind="function" beg="87" end="92">iswhite</a><span class="params">(dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#iswhite" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L87">#</a></dt>
<dd class="ddef">
<div class="summary">Returns true if c is whitespace</div></dd>
<dt class="decl">long <a class="symbol _function" name="atoi" href="./htmlsrc/std.string.html#L100" kind="function" beg="100" end="103">atoi</a><span class="tparams">(C)</span><span class="params">(in C[] <em>s</em>)</span>; <a title="Permalink to this symbol" href="#atoi" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L100">#</a></dt>
<dd class="ddef">
<div class="summary">Convert string <span class="d_psymbol"><i>s</i></span> to integer. <span class="red">Scheduled for deprecation. Use
the <span class="d_psymbol"><i>to!(int)(s)</i></span> or <span class="d_psymbol"><i>parse!(int)(s)</i></span> routines in <a href="http://
std_conv">std.conv</a></span>.</div></dd>
<dt class="decl">real <a class="symbol _function" name="atof" href="./htmlsrc/std.string.html#L111" kind="function" beg="111" end="114">atof</a><span class="tparams">(C)</span><span class="params">(in C[] <em>s</em>)</span>; <a title="Permalink to this symbol" href="#atof" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L111">#</a></dt>
<dd class="ddef">
<div class="summary">Convert string to real. <span class="red">Scheduled for deprecation. Use the <span class="d_psymbol"><i>
to!(real)(s)</i></span> or <span class="d_psymbol"><i>parse!(real)(s)</i></span> routines in <a href="http://std_conv">
std.conv</a></span>.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest" href="./htmlsrc/std.string.html#L116" kind="unittest" beg="116" end="127">unittest</a>; <a title="Permalink to this symbol" href="#unittest" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L116">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">int <a class="symbol _function" name="cmp" href="./htmlsrc/std.string.html#L139" kind="function" beg="139" end="160">cmp</a><span class="tparams">(C1, C2)</span><span class="params">(in C1[] <em>s1</em>, in C2[] <em>s2</em>)</span>; <a title="Permalink to this symbol" href="#cmp" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L139">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="icmp" href="./htmlsrc/std.string.html#L187" kind="function" beg="187" end="203">icmp</a><span class="params">(in char[] <em>s1</em>, in char[] <em>s2</em>)</span>; <a title="Permalink to this symbol" href="#icmp" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L187">#</a></dt>
<dd class="ddef">
<div class="summary">Compare two strings. cmp is case sensitive, icmp is case insensitive.</div>
<p class="sec_header">Returns:</p><table border=1 cellpadding=4 cellspacing=0>
  <tr><td>< 0</td>  <td>s1 < s2</td></tr>
  <tr><td>= 0</td>  <td>s1 == s2</td></tr>
  <tr><td>> 0</td>  <td>s1 > s2</td></tr>
  </table></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:2" href="./htmlsrc/std.string.html#L162" kind="unittest" beg="162" end="181">unittest</a>; <a title="Permalink to this symbol" href="#unittest:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L162">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:3" href="./htmlsrc/std.string.html#L205" kind="unittest" beg="205" end="226">unittest</a>; <a title="Permalink to this symbol" href="#unittest:3" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L205">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">char</dt>* <a class="symbol _function" name="toCharz" href="./htmlsrc/std.string.html#L233" kind="function" beg="233" end="236">toCharz</a><span class="params">(string <em>s</em>)</span>; <span class="attrs">[<span class="stc">deprecated</span>]</span> <a title="Permalink to this symbol" href="#toCharz" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L233">#</a></dl>
<dd class="ddef"></dd>
<dt class="decl">char</dt>* <a class="symbol _function" name="toStringz" href="./htmlsrc/std.string.html#L243" kind="function" beg="243" end="284">toStringz</a><span class="params">(const( char)[] <em>s</em>)</span>; <a title="Permalink to this symbol" href="#toStringz" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L243">#</a>)
<dd class="ddef">
<div class="summary">Convert array of chars s[] to a C-style 0 terminated string.
 s[] must not contain embedded 0's.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:4" href="./htmlsrc/std.string.html#L300" kind="unittest" beg="300" end="321">unittest</a>; <a title="Permalink to this symbol" href="#unittest:4" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L300">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">int <a class="symbol _function" name="find" href="./htmlsrc/std.string.html#L332" kind="function" beg="332" end="350">find</a><span class="params">(in char[] <em>s</em>, dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#find" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L332">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="ifind" href="./htmlsrc/std.string.html#L373" kind="function" beg="373" end="398">ifind</a><span class="params">(in char[] <em>s</em>, dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#ifind" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L373">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="rfind" href="./htmlsrc/std.string.html#L431" kind="function" beg="431" end="449">rfind</a><span class="params">(in char[] <em>s</em>, dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#rfind" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L431">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="irfind" href="./htmlsrc/std.string.html#L471" kind="function" beg="471" end="507">irfind</a><span class="params">(in char[] <em>s</em>, dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#irfind" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L471">#</a></dt>
<dd class="ddef">
<div class="summary">find, ifind _find first occurrence of c in string s.
 rfind, irfind _find last occurrence of c in string s.</div>
find, rfind are case sensitive; ifind, irfind are case insensitive.
<p class="sec_header">Returns:</p>Index in s where c is found, -1 if not found.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:5" href="./htmlsrc/std.string.html#L352" kind="unittest" beg="352" end="366">unittest</a>; <a title="Permalink to this symbol" href="#unittest:5" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L352">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:6" href="./htmlsrc/std.string.html#L400" kind="unittest" beg="400" end="424">unittest</a>; <a title="Permalink to this symbol" href="#unittest:6" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L400">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:7" href="./htmlsrc/std.string.html#L451" kind="unittest" beg="451" end="465">unittest</a>; <a title="Permalink to this symbol" href="#unittest:7" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L451">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:8" href="./htmlsrc/std.string.html#L509" kind="unittest" beg="509" end="533">unittest</a>; <a title="Permalink to this symbol" href="#unittest:8" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L509">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">int <a class="symbol _function" name="find:2" href="./htmlsrc/std.string.html#L545" kind="function" beg="545" end="593">find</a><span class="params">(in char[] <em>s</em>, in char[] <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#find:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L545">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="ifind:2" href="./htmlsrc/std.string.html#L620" kind="function" beg="620" end="678">ifind</a><span class="params">(in char[] <em>s</em>, in char[] <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#ifind:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L620">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="rfind:2" href="./htmlsrc/std.string.html#L729" kind="function" beg="729" end="759">rfind</a><span class="params">(in char[] <em>s</em>, in char[] <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#rfind:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L729">#</a></dt>
<dt class="decl">int <a class="symbol _function" name="irfind:2" href="./htmlsrc/std.string.html#L783" kind="function" beg="783" end="825">irfind</a><span class="params">(in char[] <em>s</em>, in char[] <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#irfind:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L783">#</a></dt>
<dd class="ddef">
<div class="summary">find, ifind _find first occurrence of sub[] in string s[].
 rfind, irfind _find last occurrence of sub[] in string s[].</div>
find, rfind are case sensitive; ifind, irfind are case insensitive.
<p class="sec_header">Returns:</p>Index in s where c is found, -1 if not found.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:9" href="./htmlsrc/std.string.html#L596" kind="unittest" beg="596" end="614">unittest</a>; <a title="Permalink to this symbol" href="#unittest:9" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L596">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:10" href="./htmlsrc/std.string.html#L681" kind="unittest" beg="681" end="723">unittest</a>; <a title="Permalink to this symbol" href="#unittest:10" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L681">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:11" href="./htmlsrc/std.string.html#L761" kind="unittest" beg="761" end="776">unittest</a>; <a title="Permalink to this symbol" href="#unittest:11" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L761">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:12" href="./htmlsrc/std.string.html#L827" kind="unittest" beg="827" end="861">unittest</a>; <a title="Permalink to this symbol" href="#unittest:12" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L827">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="tolower" href="./htmlsrc/std.string.html#L868" kind="function" beg="868" end="911">tolower</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#tolower" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L868">#</a></dt>
<dd class="ddef">
<div class="summary">Convert string s[] to lower case.</div></dd>
<dt class="decl">void <a class="symbol _function" name="tolowerInPlace" href="./htmlsrc/std.string.html#L917" kind="function" beg="917" end="946">tolowerInPlace</a><span class="tparams">(C)</span><span class="params">(ref C[] <em>s</em>)</span>; <a title="Permalink to this symbol" href="#tolowerInPlace" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L917">#</a></dt>
<dd class="ddef">
<div class="summary">Converts <span class="d_psymbol"><i>s</i></span> to lowercase in place.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:13" href="./htmlsrc/std.string.html#L948" kind="unittest" beg="948" end="986">unittest</a>; <a title="Permalink to this symbol" href="#unittest:13" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L948">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="toupper" href="./htmlsrc/std.string.html#L992" kind="function" beg="992" end="1035">toupper</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#toupper" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L992">#</a></dt>
<dd class="ddef">
<div class="summary">Convert string s[] to upper case.</div></dd>
<dt class="decl">void <a class="symbol _function" name="toupperInPlace" href="./htmlsrc/std.string.html#L1041" kind="function" beg="1041" end="1070">toupperInPlace</a><span class="tparams">(C)</span><span class="params">(ref C[] <em>s</em>)</span>; <a title="Permalink to this symbol" href="#toupperInPlace" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1041">#</a></dt>
<dd class="ddef">
<div class="summary">Converts <span class="d_psymbol"><i>s</i></span> to uppercase in place.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:14" href="./htmlsrc/std.string.html#L1072" kind="unittest" beg="1072" end="1099">unittest</a>; <a title="Permalink to this symbol" href="#unittest:14" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1072">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="capitalize" href="./htmlsrc/std.string.html#L1107" kind="function" beg="1107" end="1142">capitalize</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#capitalize" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1107">#</a></dt>
<dd class="ddef">
<div class="summary">Capitalize first character of string s[], convert rest of string s[]
 to lower case.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:15" href="./htmlsrc/std.string.html#L1145" kind="unittest" beg="1145" end="1164">unittest</a>; <a title="Permalink to this symbol" href="#unittest:15" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1145">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="capwords" href="./htmlsrc/std.string.html#L1173" kind="function" beg="1173" end="1214">capwords</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#capwords" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1173">#</a></dt>
<dd class="ddef">
<div class="summary">Capitalize all words in string s[].
 Remove leading and trailing whitespace.
 Replace all sequences of whitespace with a single space.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:16" href="./htmlsrc/std.string.html#L1217" kind="unittest" beg="1217" end="1227">unittest</a>; <a title="Permalink to this symbol" href="#unittest:16" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1217">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="repeat" href="./htmlsrc/std.string.html#L1233" kind="function" beg="1233" end="1251">repeat</a><span class="params">(string <em>s</em>, size_t <em>n</em>)</span>; <a title="Permalink to this symbol" href="#repeat" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1233">#</a></dt>
<dd class="ddef">
<div class="summary">Return a string that consists of s[] repeated n times.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:17" href="./htmlsrc/std.string.html#L1254" kind="unittest" beg="1254" end="1270">unittest</a>; <a title="Permalink to this symbol" href="#unittest:17" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1254">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="join" href="./htmlsrc/std.string.html#L1278" kind="function" beg="1278" end="1312">join</a><span class="params">(in string[] <em>words</em>, string <em>sep</em>)</span>; <a title="Permalink to this symbol" href="#join" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1278">#</a></dt>
<dd class="ddef">
<div class="summary">Concatenate all the strings in words[] together into one
 string; use sep[] as the separator.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:18" href="./htmlsrc/std.string.html#L1314" kind="unittest" beg="1314" end="1331">unittest</a>; <a title="Permalink to this symbol" href="#unittest:18" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1314">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string[] <a class="symbol _function" name="split" href="./htmlsrc/std.string.html#L1339" kind="function" beg="1339" end="1374">split</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#split" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1339">#</a></dt>
<dd class="ddef">
<div class="summary">Split s[] into an array of words,
 using whitespace as the delimiter.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:19" href="./htmlsrc/std.string.html#L1376" kind="unittest" beg="1376" end="1392">unittest</a>; <a title="Permalink to this symbol" href="#unittest:19" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1376">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string[] <a class="symbol _function" name="split:2" href="./htmlsrc/std.string.html#L1400" kind="function" beg="1400" end="1498">split</a><span class="params">(string <em>s</em>, string <em>delim</em>)</span>; <a title="Permalink to this symbol" href="#split:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1400">#</a></dt>
<dd class="ddef">
<div class="summary">Split s[] into an array of words,
 using delim[] as the delimiter.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:20" href="./htmlsrc/std.string.html#L1500" kind="unittest" beg="1500" end="1560">unittest</a>; <a title="Permalink to this symbol" href="#unittest:20" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1500">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string[] <a class="symbol _function" name="splitlines" href="./htmlsrc/std.string.html#L1569" kind="function" beg="1569" end="1620">splitlines</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#splitlines" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1569">#</a></dt>
<dd class="ddef">
<div class="summary">Split s[] into an array of lines,
 using CR, LF, or CR-LF as the delimiter.
 The delimiter is not included in the line.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:21" href="./htmlsrc/std.string.html#L1622" kind="unittest" beg="1622" end="1649">unittest</a>; <a title="Permalink to this symbol" href="#unittest:21" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1622">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="stripl" href="./htmlsrc/std.string.html#L1656" kind="function" beg="1656" end="1666">stripl</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#stripl" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1656">#</a></dt>
<dd class="ddef">
<div class="summary">Strips leading or trailing whitespace, or both.</div></dd>
<dt class="decl">string <a class="symbol _function" name="stripr" href="./htmlsrc/std.string.html#L1668" kind="function" beg="1668" end="1678">stripr</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#stripr" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1668">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="strip" href="./htmlsrc/std.string.html#L1680" kind="function" beg="1680" end="1683">strip</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#strip" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1680">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:22" href="./htmlsrc/std.string.html#L1685" kind="unittest" beg="1685" end="1694">unittest</a>; <a title="Permalink to this symbol" href="#unittest:22" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1685">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">bool <a class="symbol _function" name="startsWith" href="./htmlsrc/std.string.html#L1700" kind="function" beg="1700" end="1752">startsWith</a><span class="tparams">(A1, A2)</span><span class="params">(A1 <em>longer</em>, A2 <em>shorter</em>)</span>; <a title="Permalink to this symbol" href="#startsWith" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1700">#</a></dt>
<dd class="ddef">
<div class="summary">Returns <span class="d_param">true</span> if and only if the array <span class="d_param">longer</span>
 starts with array <span class="d_param">shorter</span>.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:23" href="./htmlsrc/std.string.html#L1754" kind="unittest" beg="1754" end="1783">unittest</a>; <a title="Permalink to this symbol" href="#unittest:23" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1754">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">bool <a class="symbol _function" name="endsWith" href="./htmlsrc/std.string.html#L1789" kind="function" beg="1789" end="1842">endsWith</a><span class="tparams">(A1, A2)</span><span class="params">(A1 <em>longer</em>, A2 <em>shorter</em>)</span>; <a title="Permalink to this symbol" href="#endsWith" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1789">#</a></dt>
<dd class="ddef">
<div class="summary">Returns <span class="d_param">true</span> if and only if the array <span class="d_param">longer</span>
 ends with array <span class="d_param">shorter</span>.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:24" href="./htmlsrc/std.string.html#L1844" kind="unittest" beg="1844" end="1882">unittest</a>; <a title="Permalink to this symbol" href="#unittest:24" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1844">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">C[] <a class="symbol _function" name="chomp" href="./htmlsrc/std.string.html#L1889" kind="function" beg="1889" end="1914">chomp</a><span class="tparams">(C)</span><span class="params">(C[] <em>s</em>, in C[] <em>delimiter</em> = null)</span>; <a title="Permalink to this symbol" href="#chomp" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1889">#</a></dt>
<dd class="ddef">
<div class="summary">Returns s[] sans trailing delimiter[], if any.
 If delimiter[] is null, removes trailing CR, LF, or CRLF, if any.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:25" href="./htmlsrc/std.string.html#L1916" kind="unittest" beg="1916" end="1951">unittest</a>; <a title="Permalink to this symbol" href="#unittest:25" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1916">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">C1[] <a class="symbol _function" name="chompPrefix" href="./htmlsrc/std.string.html#L1958" kind="function" beg="1958" end="1962">chompPrefix</a><span class="tparams">(C1, C2)</span><span class="params">(C1[] <em>longer</em>, C2[] <em>shorter</em>)</span>; <a title="Permalink to this symbol" href="#chompPrefix" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1958">#</a></dt>
<dd class="ddef">
<div class="summary">If <span class="d_param">longer.startsWith(shorter)</span>, returns <span class="d_param">
 longer[shorter.length .. $]</span>. Otherwise, returns <span class="d_param">longer</span>.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:26" href="./htmlsrc/std.string.html#L1964" kind="unittest" beg="1964" end="1969">unittest</a>; <a title="Permalink to this symbol" href="#unittest:26" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1964">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="chop" href="./htmlsrc/std.string.html#L1976" kind="function" beg="1976" end="1995">chop</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#chop" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1976">#</a></dt>
<dd class="ddef">
<div class="summary">Returns s[] sans trailing character, if there is one.
 If last two characters are CR-LF, then both are removed.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:27" href="./htmlsrc/std.string.html#L1998" kind="unittest" beg="1998" end="2011">unittest</a>; <a title="Permalink to this symbol" href="#unittest:27" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L1998">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="ljustify" href="./htmlsrc/std.string.html#L2019" kind="function" beg="2019" end="2027">ljustify</a><span class="params">(string <em>s</em>, int <em>width</em>)</span>; <a title="Permalink to this symbol" href="#ljustify" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2019">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="rjustify" href="./htmlsrc/std.string.html#L2030" kind="function" beg="2030" end="2038">rjustify</a><span class="params">(string <em>s</em>, int <em>width</em>)</span>; <a title="Permalink to this symbol" href="#rjustify" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2030">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="center" href="./htmlsrc/std.string.html#L2041" kind="function" beg="2041" end="2051">center</a><span class="params">(string <em>s</em>, int <em>width</em>)</span>; <a title="Permalink to this symbol" href="#center" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2041">#</a></dt>
<dd class="ddef">
<div class="summary">Left justify, right justify, or center string s[]
 in field width chars wide.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:28" href="./htmlsrc/std.string.html#L2053" kind="unittest" beg="2053" end="2076">unittest</a>; <a title="Permalink to this symbol" href="#unittest:28" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2053">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="zfill" href="./htmlsrc/std.string.html#L2083" kind="function" beg="2083" end="2091">zfill</a><span class="params">(string <em>s</em>, int <em>width</em>)</span>; <a title="Permalink to this symbol" href="#zfill" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2083">#</a></dt>
<dd class="ddef">
<div class="summary">Same as rjustify(), but fill with '0's.</div></dd>
<dt class="decl">string <a class="symbol _function" name="replace" href="./htmlsrc/std.string.html#L2097" kind="function" beg="2097" end="2120">replace</a><span class="params">(string <em>s</em>, string <em>from</em>, string <em>to</em>)</span>; <a title="Permalink to this symbol" href="#replace" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2097">#</a></dt>
<dd class="ddef">
<div class="summary">Replace occurrences of from[] with to[] in s[].</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:29" href="./htmlsrc/std.string.html#L2122" kind="unittest" beg="2122" end="2139">unittest</a>; <a title="Permalink to this symbol" href="#unittest:29" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2122">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="replaceSlice" href="./htmlsrc/std.string.html#L2145" kind="function" beg="2145" end="2166">replaceSlice</a><span class="params">(string <em>s</em>, in string <em>slice</em>, in string <em>replacement</em>)</span>; <a title="Permalink to this symbol" href="#replaceSlice" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2145">#</a></dt>
<dd class="ddef">
<div class="summary">Return a _string that is s[] with slice[] replaced by replacement[].</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:30" href="./htmlsrc/std.string.html#L2168" kind="unittest" beg="2168" end="2179">unittest</a>; <a title="Permalink to this symbol" href="#unittest:30" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2168">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="insert" href="./htmlsrc/std.string.html#L2185" kind="function" beg="2185" end="2205">insert</a><span class="params">(string <em>s</em>, size_t <em>index</em>, string <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#insert" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2185">#</a></dt>
<dd class="ddef">
<div class="summary">Insert sub[] into s[] at location index.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:31" href="./htmlsrc/std.string.html#L2207" kind="unittest" beg="2207" end="2233">unittest</a>; <a title="Permalink to this symbol" href="#unittest:31" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2207">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">size_t <a class="symbol _function" name="count" href="./htmlsrc/std.string.html#L2239" kind="function" beg="2239" end="2253">count</a><span class="params">(string <em>s</em>, string <em>sub</em>)</span>; <a title="Permalink to this symbol" href="#count" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2239">#</a></dt>
<dd class="ddef">
<div class="summary">Count up all instances of sub[] in s[].</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:32" href="./htmlsrc/std.string.html#L2255" kind="unittest" beg="2255" end="2265">unittest</a>; <a title="Permalink to this symbol" href="#unittest:32" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2255">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="expandtabs" href="./htmlsrc/std.string.html#L2273" kind="function" beg="2273" end="2325">expandtabs</a><span class="params">(string <em>str</em>, int <em>tabsize</em> = 8)</span>; <a title="Permalink to this symbol" href="#expandtabs" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2273">#</a></dt>
<dd class="ddef">
<div class="summary">Replace tabs with the appropriate number of spaces.
 tabsize is the distance between tab stops.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:33" href="./htmlsrc/std.string.html#L2327" kind="unittest" beg="2327" end="2351">unittest</a>; <a title="Permalink to this symbol" href="#unittest:33" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2327">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="entab" href="./htmlsrc/std.string.html#L2362" kind="function" beg="2362" end="2457">entab</a><span class="params">(string <em>s</em>, int <em>tabsize</em> = 8)</span>; <a title="Permalink to this symbol" href="#entab" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2362">#</a></dt>
<dd class="ddef">
<div class="summary">Replace spaces in string s with the optimal number of tabs.
 Trailing spaces or tabs in a line are removed.</div>
<p class="sec_header">Params:</p>
<table class="params">
<tr><td><em>s</em></td><td>String to convert.</td></tr>
<tr><td><em>tabsize</em></td><td>Tab columns are tabsize spaces apart. tabsize defaults to 8.</td></tr></table></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:34" href="./htmlsrc/std.string.html#L2459" kind="unittest" beg="2459" end="2500">unittest</a>; <a title="Permalink to this symbol" href="#unittest:34" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2459">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="maketrans" href="./htmlsrc/std.string.html#L2509" kind="function" beg="2509" end="2535">maketrans</a><span class="params">(in string <em>from</em>, in string <em>to</em>)</span>; <a title="Permalink to this symbol" href="#maketrans" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2509">#</a></dt>
<dd class="ddef">
<div class="summary">Construct translation table for translate().</div>
<p class="sec_header">BUG:</p>only works with ASCII</dd>
<dt class="decl">string <a class="symbol _function" name="translate" href="./htmlsrc/std.string.html#L2543" kind="function" beg="2543" end="2580">translate</a><span class="params">(string <em>s</em>, in string <em>transtab</em>, in string <em>delchars</em>)</span>; <a title="Permalink to this symbol" href="#translate" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2543">#</a></dt>
<dd class="ddef">
<div class="summary">Translate characters in s[] using table created by maketrans().
 Delete chars in delchars[].</div>
<p class="sec_header">BUG:</p>only works with ASCII</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:35" href="./htmlsrc/std.string.html#L2582" kind="unittest" beg="2582" end="2598">unittest</a>; <a title="Permalink to this symbol" href="#unittest:35" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2582">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="toString" href="./htmlsrc/std.string.html#L2604" kind="function" beg="2604" end="2607">toString</a><span class="params">(bool <em>b</em>)</span>; <a title="Permalink to this symbol" href="#toString" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2604">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:2" href="./htmlsrc/std.string.html#L2610" kind="function" beg="2610" end="2616">toString</a><span class="params">(char <em>c</em>)</span>; <a title="Permalink to this symbol" href="#toString:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2610">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:3" href="./htmlsrc/std.string.html#L2619" kind="function" beg="2619" end="2624">toString</a><span class="params">(wchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#toString:3" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2619">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:4" href="./htmlsrc/std.string.html#L2627" kind="function" beg="2627" end="2632">toString</a><span class="params">(dchar <em>c</em>)</span>; <a title="Permalink to this symbol" href="#toString:4" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2627">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:5" href="./htmlsrc/std.string.html#L2648" kind="function" beg="2648" end="2648">toString</a><span class="params">(ubyte <em>ub</em>)</span>; <a title="Permalink to this symbol" href="#toString:5" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2648">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:6" href="./htmlsrc/std.string.html#L2649" kind="function" beg="2649" end="2649">toString</a><span class="params">(ushort <em>us</em>)</span>; <a title="Permalink to this symbol" href="#toString:6" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2649">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:7" href="./htmlsrc/std.string.html#L2652" kind="function" beg="2652" end="2674">toString</a><span class="params">(uint <em>u</em>)</span>; <a title="Permalink to this symbol" href="#toString:7" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2652">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:8" href="./htmlsrc/std.string.html#L2697" kind="function" beg="2697" end="2715">toString</a><span class="params">(ulong <em>u</em>)</span>; <a title="Permalink to this symbol" href="#toString:8" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2697">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:9" href="./htmlsrc/std.string.html#L2737" kind="function" beg="2737" end="2737">toString</a><span class="params">(byte <em>b</em>)</span>; <a title="Permalink to this symbol" href="#toString:9" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2737">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:10" href="./htmlsrc/std.string.html#L2738" kind="function" beg="2738" end="2738">toString</a><span class="params">(short <em>s</em>)</span>; <a title="Permalink to this symbol" href="#toString:10" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2738">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:11" href="./htmlsrc/std.string.html#L2741" kind="function" beg="2741" end="2761">toString</a><span class="params">(int <em>i</em>)</span>; <a title="Permalink to this symbol" href="#toString:11" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2741">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:12" href="./htmlsrc/std.string.html#L2796" kind="function" beg="2796" end="2818">toString</a><span class="params">(long <em>i</em>)</span>; <a title="Permalink to this symbol" href="#toString:12" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2796">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:13" href="./htmlsrc/std.string.html#L2853" kind="function" beg="2853" end="2853">toString</a><span class="params">(float <em>f</em>)</span>; <a title="Permalink to this symbol" href="#toString:13" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2853">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:14" href="./htmlsrc/std.string.html#L2856" kind="function" beg="2856" end="2862">toString</a><span class="params">(double <em>d</em>)</span>; <a title="Permalink to this symbol" href="#toString:14" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2856">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:15" href="./htmlsrc/std.string.html#L2865" kind="function" beg="2865" end="2871">toString</a><span class="params">(real <em>r</em>)</span>; <a title="Permalink to this symbol" href="#toString:15" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2865">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:16" href="./htmlsrc/std.string.html#L2874" kind="function" beg="2874" end="2874">toString</a><span class="params">(ifloat <em>f</em>)</span>; <a title="Permalink to this symbol" href="#toString:16" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2874">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:17" href="./htmlsrc/std.string.html#L2877" kind="function" beg="2877" end="2883">toString</a><span class="params">(idouble <em>d</em>)</span>; <a title="Permalink to this symbol" href="#toString:17" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2877">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:18" href="./htmlsrc/std.string.html#L2886" kind="function" beg="2886" end="2892">toString</a><span class="params">(ireal <em>r</em>)</span>; <a title="Permalink to this symbol" href="#toString:18" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2886">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:19" href="./htmlsrc/std.string.html#L2895" kind="function" beg="2895" end="2895">toString</a><span class="params">(cfloat <em>f</em>)</span>; <a title="Permalink to this symbol" href="#toString:19" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2895">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:20" href="./htmlsrc/std.string.html#L2898" kind="function" beg="2898" end="2904">toString</a><span class="params">(cdouble <em>d</em>)</span>; <a title="Permalink to this symbol" href="#toString:20" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2898">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:21" href="./htmlsrc/std.string.html#L2907" kind="function" beg="2907" end="2913">toString</a><span class="params">(creal <em>r</em>)</span>; <a title="Permalink to this symbol" href="#toString:21" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2907">#</a></dt>
<dd class="ddef">
<div class="summary">Convert to string.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:36" href="./htmlsrc/std.string.html#L2634" kind="unittest" beg="2634" end="2646">unittest</a>; <a title="Permalink to this symbol" href="#unittest:36" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2634">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:37" href="./htmlsrc/std.string.html#L2676" kind="unittest" beg="2676" end="2694">unittest</a>; <a title="Permalink to this symbol" href="#unittest:37" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2676">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:38" href="./htmlsrc/std.string.html#L2717" kind="unittest" beg="2717" end="2735">unittest</a>; <a title="Permalink to this symbol" href="#unittest:38" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2717">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:39" href="./htmlsrc/std.string.html#L2763" kind="unittest" beg="2763" end="2793">unittest</a>; <a title="Permalink to this symbol" href="#unittest:39" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2763">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:40" href="./htmlsrc/std.string.html#L2820" kind="unittest" beg="2820" end="2850">unittest</a>; <a title="Permalink to this symbol" href="#unittest:40" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2820">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="toString:22" href="./htmlsrc/std.string.html#L2923" kind="function" beg="2923" end="2933">toString</a><span class="params">(long <em>value</em>, uint <em>radix</em>)</span>; <a title="Permalink to this symbol" href="#toString:22" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2923">#</a></dt>
<dt class="decl">string <a class="symbol _function" name="toString:23" href="./htmlsrc/std.string.html#L2936" kind="function" beg="2936" end="2958">toString</a><span class="params">(ulong <em>value</em>, uint <em>radix</em>)</span>; <a title="Permalink to this symbol" href="#toString:23" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2936">#</a></dt>
<dd class="ddef">
<div class="summary">Convert value to string in _radix radix.</div>
radix must be a value from 2 to 36.
 value is treated as a signed value only if radix is 10.
 The characters A through Z are used to represent values 10 through 36.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:41" href="./htmlsrc/std.string.html#L2960" kind="unittest" beg="2960" end="2981">unittest</a>; <a title="Permalink to this symbol" href="#unittest:41" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2960">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="toString:24" href="./htmlsrc/std.string.html#L2992" kind="function" beg="2992" end="2995">toString</a><span class="params">(const char * <em>s</em>)</span>; <a title="Permalink to this symbol" href="#toString:24" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2992">#</a></dt>
<dd class="ddef">
<div class="summary">Convert C-style 0 terminated string s to string string.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:42" href="./htmlsrc/std.string.html#L2997" kind="unittest" beg="2997" end="3011">unittest</a>; <a title="Permalink to this symbol" href="#unittest:42" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L2997">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="format" href="./htmlsrc/std.string.html#L3019" kind="function" beg="3019" end="3030">format</a><span class="params">(...)</span>; <a title="Permalink to this symbol" href="#format" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3019">#</a></dt>
<dd class="ddef">
<div class="summary">Format arguments into a string.</div></dd>
<dt class="decl">char[] <a class="symbol _function" name="sformat" href="./htmlsrc/std.string.html#L3038" kind="function" beg="3038" end="3062">sformat</a><span class="params">(char[] <em>s</em>, ...)</span>; <a title="Permalink to this symbol" href="#sformat" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3038">#</a></dt>
<dd class="ddef">
<div class="summary">Format arguments into string <i>s</i> which must be large
 enough to hold the result. Throws RangeError if it is not.</div>
<p class="sec_header">Returns:</p>s</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:43" href="./htmlsrc/std.string.html#L3065" kind="unittest" beg="3065" end="3103">unittest</a>; <a title="Permalink to this symbol" href="#unittest:43" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3065">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">bool <a class="symbol _function" name="inPattern" href="./htmlsrc/std.string.html#L3125" kind="function" beg="3125" end="3154">inPattern</a><span class="params">(dchar <em>c</em>, in string <em>pattern</em>)</span>; <a title="Permalink to this symbol" href="#inPattern" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3125">#</a></dt>
<dd class="ddef">
<div class="summary">See if character c is in the pattern.</div>
<p class="sec_header">Patterns:</p>A <i>pattern</i> is an array of characters much like a <i>character
  class</i> in regular expressions. A sequence of characters
  can be given, such as "abcde". The '-' can represent a range
  of characters, as "a-e" represents the same pattern as "abcde".
  "a-fA-F0-9" represents all the hex characters.
  If the first character of a pattern is '^', then the pattern
  is negated, i.e. "^0-9" means any character except a digit.
  The functions inPattern, <b>countchars</b>, <b>removeschars</b>,
  and <b>squeeze</b>
  use patterns.
<p class="sec_header">Note:</p>In the future, the pattern syntax may be improved
  to be more like regular expression character classes.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:44" href="./htmlsrc/std.string.html#L3157" kind="unittest" beg="3157" end="3201">unittest</a>; <a title="Permalink to this symbol" href="#unittest:44" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3157">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">int <a class="symbol _function" name="inPattern:2" href="./htmlsrc/std.string.html#L3208" kind="function" beg="3208" end="3220">inPattern</a><span class="params">(dchar <em>c</em>, string[] <em>patterns</em>)</span>; <a title="Permalink to this symbol" href="#inPattern:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3208">#</a></dt>
<dd class="ddef">
<div class="summary">See if character c is in the intersection of the patterns.</div></dd>
<dt class="decl">size_t <a class="symbol _function" name="countchars" href="./htmlsrc/std.string.html#L3227" kind="function" beg="3227" end="3236">countchars</a><span class="params">(string <em>s</em>, string <em>pattern</em>)</span>; <a title="Permalink to this symbol" href="#countchars" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3227">#</a></dt>
<dd class="ddef">
<div class="summary">Count characters in s that match pattern.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:45" href="./htmlsrc/std.string.html#L3239" kind="unittest" beg="3239" end="3249">unittest</a>; <a title="Permalink to this symbol" href="#unittest:45" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3239">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="removechars" href="./htmlsrc/std.string.html#L3256" kind="function" beg="3256" end="3277">removechars</a><span class="params">(string <em>s</em>, in string <em>pattern</em>)</span>; <a title="Permalink to this symbol" href="#removechars" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3256">#</a></dt>
<dd class="ddef">
<div class="summary">Return string that is s with all characters removed that match pattern.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:46" href="./htmlsrc/std.string.html#L3280" kind="unittest" beg="3280" end="3292">unittest</a>; <a title="Permalink to this symbol" href="#unittest:46" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3280">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="squeeze" href="./htmlsrc/std.string.html#L3301" kind="function" beg="3301" end="3338">squeeze</a><span class="params">(string <em>s</em>, string <em>pattern</em> = null)</span>; <a title="Permalink to this symbol" href="#squeeze" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3301">#</a></dt>
<dd class="ddef">
<div class="summary">Return string where sequences of a character in s[] from pattern[]
 are replaced with a single instance of that character.
 If pattern is null, it defaults to all characters.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:47" href="./htmlsrc/std.string.html#L3341" kind="unittest" beg="3341" end="3357">unittest</a>; <a title="Permalink to this symbol" href="#unittest:47" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3341">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">S1 <a class="symbol _function" name="munch" href="./htmlsrc/std.string.html#L3380" kind="function" beg="3380" end="3393">munch</a><span class="tparams">(S1, S2)</span><span class="params">(ref S1 <em>s</em>, S2 <em>pattern</em>)</span>; <a title="Permalink to this symbol" href="#munch" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3380">#</a></dt>
<dd class="ddef">
<div class="summary">Finds the position <span class="d_param">pos</span> of the first character in <span class="d_param">
 s</span> that does not match <span class="d_param">pattern</span> (in the terminology used by
 <a href="std_string.html">inPattern</a>). Updates <span class="d_param">s =
 s[pos..$]</span>. Returns the slice from the beginning of the original
 (before update) string up to, and excluding, <span class="d_param">pos</span>.</div>
<p class="sec_header">Example:</p><pre class="d_code">
<span class="i">string</span> <span class="i">s</span> = <span class="sl">"123abc"</span>;
<span class="i">string</span> <span class="i">t</span> = <span class="i">munch</span>(<span class="i">s</span>, <span class="sl">"0123456789"</span>);
<span class="k">assert</span>(<span class="i">t</span> == <span class="sl">"123"</span> &amp;&amp; <span class="i">s</span> == <span class="sl">"abc"</span>);
<span class="i">t</span> = <span class="i">munch</span>(<span class="i">s</span>, <span class="sl">"0123456789"</span>);
<span class="k">assert</span>(<span class="i">t</span> == <span class="sl">""</span> &amp;&amp; <span class="i">s</span> == <span class="sl">"abc"</span>);
</pre>
<p class="bl"/>
The <span class="d_param">munch</span> function is mostly convenient for skipping
certain category of characters (e.g. whitespace) when parsing
strings. (In such cases, the return value is not used.)</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:48" href="./htmlsrc/std.string.html#L3395" kind="unittest" beg="3395" end="3402">unittest</a>; <a title="Permalink to this symbol" href="#unittest:48" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3395">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="succ" href="./htmlsrc/std.string.html#L3412" kind="function" beg="3412" end="3453">succ</a><span class="params">(string <em>s</em>)</span>; <a title="Permalink to this symbol" href="#succ" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3412">#</a></dt>
<dd class="ddef">
<div class="summary">Return string that is the 'successor' to s[].
 If the rightmost character is a-zA-Z0-9, it is incremented within
 its case or digits. If it generates a carry, the process is
 repeated with the one to its immediate left.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:49" href="./htmlsrc/std.string.html#L3455" kind="unittest" beg="3455" end="3473">unittest</a>; <a title="Permalink to this symbol" href="#unittest:49" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3455">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="tr" href="./htmlsrc/std.string.html#L3506" kind="function" beg="3506" end="3615">tr</a><span class="params">(string <em>str</em>, string <em>from</em>, string <em>to</em>, string <em>modifiers</em> = null)</span>; <a title="Permalink to this symbol" href="#tr" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3506">#</a></dt>
<dd class="ddef">
<div class="summary">Replaces characters in str[] that are in from[]
 with corresponding characters in to[] and returns the resulting
 string.</div>
<p class="sec_header">Params:</p>
<table class="params">
<tr><td><em>modifiers</em></td><td>a string of modifier characters</td></tr></table>
<p class="sec_header">Modifiers:</p><table border=1 cellspacing=0 cellpadding=5>
        <tr> <th>Modifier <th>Description
        <tr> <td><b>c</b> <td>Complement the list of characters in from[]
        <tr> <td><b>d</b> <td>Removes matching characters with no corresponding replacement in to[]
        <tr> <td><b>s</b> <td>Removes adjacent duplicates in the replaced characters
        </table>
<p class="bl"/>
    If modifier <b>d</b> is present, then the number of characters
    in to[] may be only 0 or 1.
<p class="bl"/>
    If modifier <b>d</b> is not present and to[] is null,
    then to[] is taken _to be the same as from[].
<p class="bl"/>
    If modifier <b>d</b> is not present and to[] is shorter
    than from[], then to[] is extended by replicating the
    last character in to[].
<p class="bl"/>
    Both from[] and to[] may contain ranges using the <b>-</b>
    character, for example <b>a-d</b> is synonymous with <b>abcd</b>.
    Neither accept a leading <b>^</b> as meaning the complement of
    the string (use the <b>c</b> modifier for that).</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:50" href="./htmlsrc/std.string.html#L3617" kind="unittest" beg="3617" end="3656">unittest</a>; <a title="Permalink to this symbol" href="#unittest:50" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3617">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">bool <a class="symbol _function" name="isNumeric" href="./htmlsrc/std.string.html#L3706" kind="function" beg="3706" end="3846">isNumeric</a><span class="params">(string <em>s</em>, in bool <em>bAllowSep</em> = false)</span>; <span class="attrs">[<span class="stc">final</span>]</span> <a title="Permalink to this symbol" href="#isNumeric" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3706">#</a></dt>
<dd class="ddef">
<div class="summary">[in] string s can be formatted in the following ways:</div>
Integer Whole Number:
 (for byte, ubyte, short, ushort, int, uint, long, and ulong)
 ['+'|'-']digit(s)[U|L|UL]
<p class="sec_header">Examples:</p>123, 123UL, 123L, +123U, -123L
<p class="bl"/>
 Floating-Point Number:
 (for float, double, real, ifloat, idouble, and ireal)
 ['+'|'-']digit(s)[.][digit(s)][[e-|e+]digit(s)][i|f|L|Li|fi]]
      or [nan|nani|inf|-inf]
<p class="sec_header">Examples:</p>+123., -123.01, 123.3e-10f, 123.3e-10fi, 123.3e-10L
<p class="bl"/>
 (for cfloat, cdouble, and creal)
 ['+'|'-']digit(s)[.][digit(s)][[e-|e+]digit(s)][+]
         [digit(s)[.][digit(s)][[e-|e+]digit(s)][i|f|L|Li|fi]]
      or [nan|nani|nan+nani|inf|-inf]
<p class="sec_header">Examples:</p>nan, -123e-1+456.9e-10Li, +123e+10+456i, 123+456
<p class="bl"/>
 [in] bool bAllowSep
 False by default, but when set to true it will accept the
 separator characters "," and "_" within the string, but these
 characters should be stripped from the string before using any
 of the conversion functions like toInt(), toFloat(), and etc
 else an error will occur.
<p class="bl"/>
 Also please note, that no spaces are allowed within the string
 anywhere whether it's a leading, trailing, or embedded space(s),
 thus they too must be stripped from the string before using this
 function, or any of the conversion functions.</dd>
<dt class="decl">bool <a class="symbol _function" name="isNumeric:2" href="./htmlsrc/std.string.html#L3849" kind="function" beg="3849" end="3852">isNumeric</a><span class="params">(...)</span>; <a title="Permalink to this symbol" href="#isNumeric:2" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3849">#</a></dt>
<dd class="ddef">
<div class="summary">Allow any object as a parameter</div></dd>
<dt class="decl">bool <a class="symbol _function" name="isNumeric:3" href="./htmlsrc/std.string.html#L3855" kind="function" beg="3855" end="3938">isNumeric</a><span class="params">(TypeInfo[] <em>_arguments</em>, va_list <em>_argptr</em>)</span>; <a title="Permalink to this symbol" href="#isNumeric:3" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3855">#</a></dt>
<dd class="ddef">
<div class="summary">Check only the first parameter, all others will be ignored.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:51" href="./htmlsrc/std.string.html#L3940" kind="unittest" beg="3940" end="3991">unittest</a>; <a title="Permalink to this symbol" href="#unittest:51" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L3940">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">char[] <a class="symbol _function" name="soundex" href="./htmlsrc/std.string.html#L4022" kind="function" beg="4022" end="4089">soundex</a><span class="params">(string <em>string</em>, char[] <em>buffer</em> = null)</span>; <a title="Permalink to this symbol" href="#soundex" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4022">#</a></dt>
<dd class="ddef">
<div class="summary">Soundex algorithm.</div>
The Soundex algorithm converts a word into 4 characters
 based on how the word sounds phonetically. The idea is that
 two spellings that sound alike will have the same Soundex
 value, which means that Soundex can be used for fuzzy matching
 of names.
<p class="sec_header">Params:</p>
<table class="params">
<tr><td><em>string</em></td><td>String to convert to Soundex representation.</td></tr>
<tr><td><em>buffer</em></td><td>Optional 4 char array to put the resulting Soundex
      characters into. If null, the return value
      buffer will be allocated on the heap.</td></tr></table>
<p class="sec_header">Returns:</p>The four character array with the Soundex result in it.
  Returns null if there is no Soundex representation for the string.
<p class="sec_header">See Also:</p><a href="http://en.wikipedia.org/wiki/Soundex">Wikipedia</a>,
  <a href="http://www.archives.gov/publications/general-info-leaflets/55.html">The Soundex Indexing System</a>
<p class="sec_header"><span class="red">Bugs:</span></p>Only works well with English names.
  There are other arguably better Soundex algorithms,
  but this one is the standard one.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:52" href="./htmlsrc/std.string.html#L4091" kind="unittest" beg="4091" end="4132">unittest</a>; <a title="Permalink to this symbol" href="#unittest:52" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4091">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string[string] <a class="symbol _function" name="abbrev" href="./htmlsrc/std.string.html#L4169" kind="function" beg="4169" end="4206">abbrev</a><span class="params">(string[] <em>values</em>)</span>; <a title="Permalink to this symbol" href="#abbrev" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4169">#</a></dt>
<dd class="ddef">
<div class="summary">Construct an associative array consisting of all
 abbreviations that uniquely map to the strings in values.</div>
This is useful in cases where the user is expected to type
 in one of a known set of strings, and the program will helpfully
 autocomplete the string once sufficient characters have been
 entered that uniquely identify it.
<p class="sec_header">Example:</p><pre class="d_code">
<span class="k">import</span> <span class="i">std</span>.<span class="i">stdio</span>;
<span class="k">import</span> <span class="i">std</span>.<span class="i">string</span>;

<span class="k">void</span> <span class="i">main</span>()
{
   <span class="k">static</span> <span class="i">string</span>[] <span class="i">list</span> = [ <span class="sl">"food"</span>, <span class="sl">"foxy"</span> ];

   <span class="k">auto</span> <span class="i">abbrevs</span> = <span class="i">std</span>.<span class="i">string</span>.<span class="i">abbrev</span>(<span class="i">list</span>);

   <span class="k">foreach</span> (<span class="i">key</span>, <span class="i">value</span>; <span class="i">abbrevs</span>)
   {
      <span class="i">writefln</span>(<span class="sl">"%s =&gt; %s"</span>, <span class="i">key</span>, <span class="i">value</span>);
   }
}
</pre>
 produces the output:
 <pre>
 fox =&gt; foxy
 food =&gt; food
 foxy =&gt; foxy
 foo =&gt; food
 </pre></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:53" href="./htmlsrc/std.string.html#L4208" kind="unittest" beg="4208" end="4233">unittest</a>; <a title="Permalink to this symbol" href="#unittest:53" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4208">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">size_t <a class="symbol _function" name="column" href="./htmlsrc/std.string.html#L4241" kind="function" beg="4241" end="4266">column</a><span class="params">(string <em>str</em>, int <em>tabsize</em> = 8)</span>; <a title="Permalink to this symbol" href="#column" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4241">#</a></dt>
<dd class="ddef">
<div class="summary">Compute column number after string if string starts in the
 leftmost column, which is numbered starting from 0.</div></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:54" href="./htmlsrc/std.string.html#L4268" kind="unittest" beg="4268" end="4277">unittest</a>; <a title="Permalink to this symbol" href="#unittest:54" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4268">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="wrap" href="./htmlsrc/std.string.html#L4297" kind="function" beg="4297" end="4361">wrap</a><span class="params">(string <em>s</em>, int <em>columns</em> = 80, string <em>firstindent</em> = null, string <em>indent</em> = null, int <em>tabsize</em> = 8)</span>; <a title="Permalink to this symbol" href="#wrap" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4297">#</a></dt>
<dd class="ddef">
<div class="summary">Wrap text into a paragraph.</div>
The input text string s is formed into a paragraph
 by breaking it up into a sequence of lines, delineated
 by \n, such that the number of columns is not exceeded
 on each line.
 The last line is terminated with a \n.
<p class="sec_header">Params:</p>
<table class="params">
<tr><td><em>s</em></td><td>text string to be wrapped</td></tr>
<tr><td><em>columns</em></td><td>maximum number of _columns in the paragraph</td></tr>
<tr><td><em>firstindent</em></td><td>string used to _indent first line of the paragraph</td></tr>
<tr><td><em>indent</em></td><td>string to use to _indent following lines of the paragraph</td></tr>
<tr><td><em>tabsize</em></td><td>column spacing of tabs</td></tr></table>
<p class="sec_header">Returns:</p>The resulting paragraph.</dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:55" href="./htmlsrc/std.string.html#L4363" kind="unittest" beg="4363" end="4376">unittest</a>; <a title="Permalink to this symbol" href="#unittest:55" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4363">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="isEmail" href="./htmlsrc/std.string.html#L4384" kind="function" beg="4384" end="4430">isEmail</a><span class="params">(string <em>s</em>)</span>; <span class="attrs">[<span class="stc">deprecated</span>]</span> <a title="Permalink to this symbol" href="#isEmail" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4384">#</a></dt>
<dd class="ddef">
<div class="summary">Does string s[] start with an email address?</div>
<p class="sec_header"><span class="red">Deprecated:</span></p>use std.uri.emailLength</dd>
<dt class="decl">string <a class="symbol _function" name="isURL" href="./htmlsrc/std.string.html#L4439" kind="function" beg="4439" end="4488">isURL</a><span class="params">(string <em>s</em>)</span>; <span class="attrs">[<span class="stc">deprecated</span>]</span> <a title="Permalink to this symbol" href="#isURL" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4439">#</a></dt>
<dd class="ddef">
<div class="summary">Does string s[] start with a URL?</div>
<p class="sec_header"><span class="red">Deprecated:</span></p>use std.uri.uriLength</dd>
<dt class="decl">S <a class="symbol _function" name="textImpl" href="./htmlsrc/std.string.html#L4492" kind="function" beg="4492" end="4500">textImpl</a><span class="tparams">(S, T...)</span><span class="params">(T <em>args</em>)</span>; <span class="attrs">[<span class="prot">private</span>]</span> <a title="Permalink to this symbol" href="#textImpl" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4492">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">string <a class="symbol _function" name="text" href="./htmlsrc/std.string.html#L4502" kind="function" beg="4502" end="4502">text</a><span class="tparams">(T...)</span><span class="params">(T <em>args</em>)</span>; <a title="Permalink to this symbol" href="#text" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4502">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">wstring <a class="symbol _function" name="wtext" href="./htmlsrc/std.string.html#L4503" kind="function" beg="4503" end="4503">wtext</a><span class="tparams">(T...)</span><span class="params">(T <em>args</em>)</span>; <a title="Permalink to this symbol" href="#wtext" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4503">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl">dstring <a class="symbol _function" name="dtext" href="./htmlsrc/std.string.html#L4504" kind="function" beg="4504" end="4504">dtext</a><span class="tparams">(T...)</span><span class="params">(T <em>args</em>)</span>; <a title="Permalink to this symbol" href="#dtext" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4504">#</a></dt>
<dd class="ddef"></dd>
<dt class="decl"><a class="symbol _unittest" name="unittest:56" href="./htmlsrc/std.string.html#L4506" kind="unittest" beg="4506" end="4511">unittest</a>; <a title="Permalink to this symbol" href="#unittest:56" class="symlink">¶</a><a title="Go to the HTML source file" class="srclink" href="./htmlsrc/std.string.html#L4506">#</a></dt>
<dd class="ddef"></dd>)
</div>
<div id="footer">
  <p>Public Domain</p>
  <p>Page generated by <a href="http://code.google.com/p/dil">dil</a> on Sun Dec 28 04:26:46 2008. Rendered by <a href="http://code.google.com/p/dil/wiki/Kandil">kandil</a>.</p>
</div>
</body>
</html>